    Modify Remote File Distribution Job

    This window allows you to modify a remote file distribution job.
    the window contains the following fields.

    Job name

    This read-only field specifies the name of the remote file distribution 
    job.

    Description

    Use this field to give a brief description of the job. This is used
    along with the name to help identify jobs in the status logs.


    Install to Hosts

    You can use this field to limit which hosts will be accessed during
    the job. Leave a blank space between host names for multiple
    entries. You can also click on the arrow button to the right to pop
    up a pick list of all hosts in the current pool with the selected
    O/S type(s) and make your selection(s) from there.

    Target Directory

    Use this field to specify the name of the directory where the files
    should be copied.

    Windows style paths may also be entered, e.g. c:\users\charlie.
    However, this path will be converted to //c/users/charlie on any
    UNIX platform that is in the current hostnames selection field or
    in the current pool. This can be changed by entering two paths.
    The following examples show valid entries:
 
            c:\users\charlie|/home/charlie
            /home/charlie|c:\users\charlie
            /home/charlie|\users\charlie
 
    The symbol '|' is the pathname delimiter. Only one can occur in the
    field. Each individual pathname must not contain both '/' and '\'. 
    A zero length pathname is an error condtion.

    Min. Disk

    You can use this field to define the minimum amount of free disk
    space the partition containing the target directory must have before
    this remote file distribution job will execute. You can specify the
    units in bytes or Kbytes.

    Pre-Install Script

    You can use this field to specify any scripts or programs which
    should be executed on the destination hosts before transferring the
    files. Enter the full pathname to the script and, optionally, an
    input data file name. Multiple scripts should be separated by
    semi-colons. This is not supported on NT.

    Directory

    You can use this field to specify the directory where the
    Pre-Install Script will be put and then run.

    Post-Install Script

    You can use this field to specify any scripts or programs which
    should be executed on the destination hosts after the files are
    transferred. Enter the full pathname to the script and, optionally,
    an input data file name. Multiple scripts should be separated by
    semi-colons. This is not supported on NT.

    Directory

    You can use this field to specify the directory where the
    Post-Install Script will be put and then run.


    Source Directory

    You can use this field to specify the directory where this job will
    be started on the local host.

    Number of Retries

    Use this field to choose how many times a remote copy to a given
    host should be attempted before the copy operation fails. This can
    be 0 (the default) through 5 times.

    Rollback on

    You can use this toggle to select if the copied files should be
    removed (or not) from the receiving hosts when an error occurs
    during the remote copy process. The choices are to remove the copied
    files from:

    + Ignore Errors (the default; no copied files are removed)
    + Failed Hosts Only (remove copies from failed hosts only)
    + All Hosts (if one host fails, remove copies from all hosts)

    Overwrite Files

    Use this toggle to specify if existing files in the destination
    directory should be overwritten by the new files being copied AND if
    new directories should be created as needed during the distribution
    job. The default is Yes.

    Use Relay Host

    Use this toggle to specify if this distribution of files should be
    broadcast to any Relay Hosts for distribution to hosts on other
    sub-nets. The default is No.

    If you set this to Yes, you should also specify the Broadcast Relay
    Hosts in the Session Preferences window. See "CONFIGURE" on page 2-1
    for more details.

    Distribution Files

    This field is an editable scrolled list. You can click in this list
    once to activate it and then type in the full pathname of the files
    you want to be copied to other hosts.


    Time of RFD Job

    You can use this field, along with the Schedule Type field, to
    schedule when a file distribution should be executed. See "TIME
    FORMATS" on page C-1 for details on specifying this value.

    Schedule Type

    Use this toggle to specify how and when the file distribution will
    occur. The choices are:

    + Weekly When you click on this option, the days of the week will be
      displayed. Select the days of the week the file distribution should
      occur. The Time of RFD job field should contain the time of day the
      file distribution will occur.

    + Manual This is the default setting. You can run this type of job
      by clicking on the Execute Now button.

    + Monthly When you click on this option, the days of the month will
      be displayed. Select the days of the month the file distribution
      should occur. The Time of RFD job field should contain the time of
      day the file distribution will occur.

    + One time Use this option to specify in the Time of RFD job field a
      one-time date and time to run the file distribution. See "TIME
      FORMATS" on page C-1 for details on specifying this value.

    Buttons

    This window contains the following buttons:

    Modify

    Click on this button to save the file distribution process.

    If you didn't enter the Target Directory and Distribution Files
    information, Enlighten will prompt you to supply the missing
    information. If any of the Distribution Files do not exist,
    Enlighten will popup an error box informing you which files could
    not be found and the remote distribution will stop. Otherwise, a
    status window will popup to show the progress of the remote file
    distribution.

    Clear Fields

    Click on this button to clear the existing choices in all fields.

    Execute Now

    Click on this button to execute the file distribution job
    immediately without having to save it or schedule it.

    Next

    You can use the Next button to modify additional remote
    distribution jobs if you've selected more than one to modify from
    the Remote File Distribution Configuration list.

    Close

    Click on this button to discard any changes and close the window.

